home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / minix / up1510b.tgz / up1510b / Install.150 next >
Internet Message Format  |  1990-07-15  |  24KB
  1. From: meulenbr@cstw68.prl.philips.nl (Frans Meulenbroeks)
  2. Newsgroups: comp.os.minix
  3. Subject: ST 1.5.0  part #0 (installation guide)
  4. Message-ID: <859@prles2.UUCP>
  5. Date: 16 Jan 90 21:01:32 GMT
  6. Reply-To: meulenbr@cst.prl.philips.nl ()
  7. Organization: Centre for Software Technology, Philips Eindhoven
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                Minix ST 1.5.0 upgrade guide
  14.  
  15.                    Frans Meulenbroeks.
  16.                      january 1990.
  17.  
  18.  
  19.     To Ruud and Erik,
  20.     whose early arrival delayed this project at least a month
  21.     but it was (and is) worth every second.
  22.  
  23.  
  24.  
  25. INTRODUCTION
  26.  
  27. This document describes how to upgrade your out-of-the-box Minix ST 1.1
  28. sources to the 1.5.0 version.
  29. The upgrade kit will not work with other ST kernels (e.g. gkernel, or
  30. the kernel with Poole fs).
  31.  
  32. Since the new version is pretty compatible with PC 1.5.0 it is
  33. baptised ST 1.5.0 and not 1.2. Version 1.2, 1.3 and 1.4 are never distributed.
  34.  
  35. ST 1.5.0 is as much compatible with PC 1.5.0 as possible.
  36. There are some differences though:
  37. - PC 1.5.0 supports Amoeba networking. 
  38.   Since I don't have an Ethernet card for the ST, and because I'm not
  39.   aware of the existence of such a thing I did not look at this
  40. - ST 1.5.0 supports formatting of disks
  41. - ST 1.5.0 supports several hardware clocks. Note that since I do not 
  42.   have all those hardware not all stuff is tested by me.
  43. - several bug fixes were added in order to get things working on
  44.   an ST. Things which always break code on the ST are assumptions that
  45.   sizeof(char *) == sizeof(int), and dereferenced NULL pointers.
  46. - elle
  47.   When typing these release notes, I noticed that elle is missing.
  48.   Since I do not have elle sources this has been left out.
  49. - stterm
  50.   The PC term program was terribly slow on the ST due to shadowing.
  51.   Therefore I included another communications program, which I baptised
  52.   stterm. It is based upon a program received through usenet (sorry,
  53.   forgot the authors name), and is reworked by J.R. Bammi.
  54.  
  55. The idea behind this upgrade is to get close to the PC version.
  56. For that reason I regretfully could not include several functional
  57. enhancements, which I really would like to see included.
  58. Fortunately at least some of these are rumored to be in future
  59. versions.
  60.  
  61. WARNING
  62.  
  63. This upgrade is not trivial. 
  64. It can take several evenings to do the upgrade, especially if you have a
  65. floppy only system.
  66. It helps very much if you have already build a minix system in the
  67. past. If you haven't done so, you might consider trying that first
  68. before starting on this upgrade.
  69. Also some familiarity with the minix commands is needed.
  70.  
  71. There might be one problem left in the kernel! I just got a crash
  72. yesterday, which I was unable to reproduce. If you encounter problems
  73. and discover either a fix, or a way to reproduce it, let me know.
  74. However, it is also quite possible that this problem is due to flaky hardware
  75. (you should have seen my system to know what I mean).
  76. I'll try to see if I can reproduce the problem. If I come up with something I'll
  77. let you know....
  78.  
  79. DISCLAIMER
  80.  
  81. This version is not an official version. That is: most likely it will
  82. never be distributed by PH. 
  83. A previous upgrade kit was sent to Johan Stevenson for official
  84. approval. Unfortunately he did not have the time to work on it.
  85. Therefore Johan agreed that I would distribute the stuff to a small beta
  86. test group, and then release it as a semi official release.
  87. Also ast encouraged me to work on this.
  88.  
  89. After a lot of comments from the beta testers (thanks boys!) and a lot
  90. of changes based upon those comments, this upgrade kit is the result.
  91.  
  92. The above means that this upgrade kit is *NOT* officially approved by Johan,
  93. but I think at the time this is as close as official as we (the net) can
  94. get it, and therefore I suggest to use this as THE 1.5.0 version until
  95. something official comes up.
  96.  
  97. Note: Installing these changes will void your warranty. 
  98.       Installing the changes is *NOT* recommended if you haven't build a
  99.       minix kernel before and/or if you have no C/Unix experience.
  100.       Both me (Frans Meulenbroeks), the beta testers, and all persons
  101.       that contributed code, do not grant any warranty, and will not be
  102.       liable to any damage done to you or your system, either direct or
  103.       indirect.
  104.  
  105.       If you cannot live with this, just discard this upgrade kit.
  106.  
  107. (How is that for a change)
  108.  
  109. COPYRIGHT NOTICE
  110.  
  111. A number of the sources in this upgrade kit are copyrighted. 
  112. See the various files for more details.
  113. The files have one thing in common: they are all snatched from Usenet
  114. and IMHO they may be distributed freely.
  115.  
  116. As far as this upgrade kit concerns I want to make the following
  117. statement:
  118. "This upgrade kit carries a compilation copyright as far as the various
  119.  source files concerns. This document is copyrighted by F. Meulenbroeks,
  120.  1989. Everyone is granted permission to redistribute both the upgrade
  121.  kit and this document freely. However, it is explicitly forbidden to
  122.  make money from this in any way. "
  123.  
  124. Or in other words: feel free to share this with anyone else, but don't
  125. ask money for it. It is explicitly forbidden to make money off this.
  126. This implies that it is forbidden to put this in any PD library who
  127. sells software for a larger amount than is needed for media cost (and
  128. shipping if appropriate).
  129.  
  130. To some of you the above statement may seem quite rigid. However, I
  131. hate to see other people make money out of my work. 
  132. Explicit permission is granted to ast to use (parts of) this in future
  133. releases.
  134.  
  135. HARDWARE REQUIREMENTS
  136.  
  137. It might not be possible to install this upgrade if you have only 0.5 MB of
  138. memory, or only a single sided floppy drive.
  139. If you want to try with such a system I wish you good luck.
  140. If you succeed, I'd like to hear from you, and how you achieved this.
  141. Perhaps we can add a section to this document.
  142.  
  143. If you have a bare 520 with a SS drive only, you will not be able to do
  144. this upgrade.
  145.  
  146. HOW THINGS ARE ARRANGED
  147.  
  148. The whole upgrade kit consist of 23 parts. These are:
  149. part 0: this installation guide
  150. part 1: include stuff (called inclshar)
  151. part 2: lib stuff (called libshar.uue)
  152. part 3-12: commands stuff (called comm1 - comm10)
  153. part 13: sttools stuff (called sttlsshar)
  154. part 14: test stuff (called testshar)
  155. part 15: tos stuff (called tos.arc)
  156. part 16-17: fs stuff (called fsshar1 - fsshar2)
  157. part 18: mm stuff (called mmshar)
  158. part 19-22: kernel stuff (called kernshr1 - kernshr4)
  159.  
  160. Apart from part 0 (which is this document and is plain ascii text) and
  161. part 15 (which is a uuencoded arc file), all parts are send as uuencoded,
  162. compressed shar files. This means that you have to uudecode all parts
  163. first, then uncompress them using compress -d, and then extract them
  164. using sh. This format is equivalent to the format in which the PC 1.5.0
  165. was posted.
  166.  
  167. All the upgrades consist of either the complete files or a cdiff with the
  168. original out-of-the-box 1.1 sources. 
  169. I have tacked a .cdif extension to all cdif files. 
  170. Unfortunately due to the limit minix places on file names, sometimes
  171. the trailing .cdif may be truncated to .cdi or even .cd
  172.  
  173. Note that in 1.5.0 the h directory does not exist any more, but has
  174. been renamed to /usr/include/minix.
  175.  
  176. Also the lib directory has been split into pieces. For the ST the
  177. interesting subdirectories are atari ansi posix and other
  178.  
  179. Sometimes you'll be asked to take stuff from the PC 1.5.0 distribution.
  180. This is done to avoid massive postings of stuff which is posted by ast
  181. less than a month ago. I twice suggested you'd save these postings.
  182. If you didn't do this bad luck to you. Try to find these postings on an
  183. archive server first. You'll need them!
  184.  
  185. In one or two cases you're supplied with a patch to a PC posting.
  186. In that case you are encouraged to keep the PC original around as well.
  187. Future postings of ast will refer to the PC postings. I know ast will be
  188. incorporating the patch I post in the next version.
  189.  
  190. With this release the PC and ST 1.5.0 are compatible (with a few small
  191. exceptions) with respect to lib/include/commands/fs/mm/test
  192. Part of sttools is also equivalent. Due to the different environments it
  193. is not possible to fully integrate PC and ST stuff in this area.
  194. The integration of the kernel is still in the works. This integrat